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Legal information 


Use of application examples 
Application examples illustrate the solution of automation tasks through an interaction of several 
components in the form of text, graphics and/or software modules. The application examples are 
a free service by Siemens AG and/or a subsidiary of Siemens AG (“Siemens”). They are non- 
binding and make no claim to completeness or functionality regarding configuration and 
equipment. The application examples merely offer help with typical tasks; they do not constitute 
customer-specific solutions. You yourself are responsible for the proper and safe operation of the 
products in accordance with applicable regulations and must also check the function of the 
respective application example and customize it for your system. 
Siemens grants you the non-exclusive, non-sublicensable and non-transferable right to have the 
application examples used by technically trained personnel. Any change to the application 
examples is your responsibility. Sharing the application examples with third parties or copying the 
application examples or excerpts thereof is permitted only in combination with your own products. 
The application examples are not required to undergo the customary tests and quality inspections 
of a chargeable product; they may have functional and performance defects as well as errors. It is 
your responsibility to use them in such a manner that any malfunctions that may occur do not 
result in property damage or injury to persons. 


Disclaimer of liability 
Siemens shall not assume any liability, for any legal reason whatsoever, including, without 
limitation, liability for the usability, availability, completeness and freedom from defects of the 
application examples as well as for related information, configuration and performance data and 
any damage caused thereby. This shall not apply in cases of mandatory liability, for example 
under the German Product Liability Act, or in cases of intent, gross negligence, or culpable loss of 
life, bodily injury or damage to health, non-compliance with a guarantee, fraudulent 
non-disclosure of a defect, or culpable breach of material contractual obligations. Claims for 
damages arising from a breach of material contractual obligations shall however be limited to the 
foreseeable damage typical of the type of agreement, unless liability arises from intent or gross 
negligence or is based on loss of life, bodily injury or damage to health. The foregoing provisions 
do not imply any change in the burden of proof to your detriment. You shall indemnify Siemens 
against existing or future claims of third parties in this connection except where Siemens is 
mandatorily liable. 
By using the application examples you acknowledge that Siemens cannot be held liable for any 
damage beyond the liability provisions described. 


Other information 
Siemens reserves the right to make changes to the application examples at any time without 
notice. In case of discrepancies between the suggestions in the application examples and other 
Siemens publications such as catalogs, the content of the other documentation shall have 
precedence. 
The Siemens terms of use (https://support.industry.siemens.com) shall also apply. 


Security information 
Siemens provides products and solutions with industrial security functions that support the secure 
operation of plants, systems, machines and networks. 
In order to protect plants, systems, machines and networks against cyber threats, it is necessary 
to implement — and continuously maintain — a holistic, state-of-the-art industrial security concept. 
Siemens’ products and solutions constitute one element of such a concept. 
Customers are responsible for preventing unauthorized access to their plants, systems, machines 
and networks. Such systems, machines and components should only be connected to an 
enterprise network or the Internet if and to the extent such a connection is necessary and only 
when appropriate security measures (e.g. firewalls and/or network segmentation) are in place. 
For additional information on industrial security measures that may be implemented, please visit 
httos://www.siemens.com/industrialsecurity. 
Siemens’ products and solutions undergo continuous development to make them more secure. 
Siemens strongly recommends that product updates are applied as soon as they are available 
and that the latest product versions are used. Use of product versions that are no longer 
supported, and failure to apply the latest updates may increase customer's exposure to cyber 
threats. 
To stay informed about product updates, subscribe to the Siemens Industrial Security RSS Feed 


at: https:/Awww.siemens.com/industrialsecurity. 
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1 Introduction 


The use of industrial robots continues to grow. They are increasingly being used in 
machines and plants. Their standardized mechanics are well-developed and highly 
flexible in terms of their movement; as a result, robots are increasingly replacing 
expensive specialist mechanics. This also enables production from the first 
production batch without expensive modifications to machines and plants. 


Unfortunately, plant controllers and robot controllers usually constitute two different 
systems. Communication between the two controllers usually occurs solely on the 
bit level and the movement programs of the robot are stored on the robot controller 
and may only be called up by the plant controller. It is therefore difficult to trigger 
flexible robot reactions to specific plant events. 


Also, the plant controller and the robot are usually very different in terms of their 


programming, which means that it is not possible for one person to control both 
systems. Interface and coordination problems are therefore pre-programmed. 


1.1 Overview 


A complete integration of the actuation and the movement control of the robot into 
the machine and plant controller should make the use of the industrial robot in a 
production plant easier and more flexible. 

The following requirements are imposed on the automation task: 


e The robot should be fully programmable via the machine and plant controller 
(PLC). 

e The robot can be operated via the same HMI of the PLC/machine (Single Point 
of Operation). 


e Robot diagnostics should be fully possible via the PLC. 


e It should be possible to integrate further functions such as Safety Integrated 
and PROFlenergy and control them via the PLC. 


1.2 How it works 


A KUKA industrial robot is to be fully programmed and operated using a SIMATIC 
$7-1500 controller. The KUKA.PLC mxAutomation block library in the TIA Portal is 
used; this provides all the function blocks required for this purpose. Additional 
programming of the robot controller is therefore not required. 


Communication between the SIMATIC S7-1500 controller and the KUKA industrial 
robot takes place via a PROFINET connection. All commands and status 
information between the SIMATIC controller and the robot are exchanged via this 
connection. 


Note With a SIMATIC S7-1500 controller, up to five KUKA industrial robots can be 
simultaneously controlled in the TIA Portal using the KUKA.PLC mxAutomation 
block library. 


The application example presented here, however, is limited to the coupling of a 
robot to a SIMATIC S7-1500. 
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Diagram 


The following diagram provides a schematic representation of the most important 
components of the application example: 


Figure 1-1: Schematic overview of the application example 


SIMATIC CPU 
$7-1500 


KR 6 R700 SIXX 
(KR AGILUS) 


KR C4 compact 


& PROFINET IE 


The movement control of the KUKA industrial robot is fully programmed in the 
SIMATIC controller using the KUKA.PLC mxAutomation block library. The robot is 
assigned to the SIMATIC controller via a PROFINET connection as an I/O device. 


The KUKA industrial robot consists of the KUKA robot controller KR C4 and the 
robot arm. The interpreter for the KUKA.PLC mxAutomation block library 
commands is installed on the robot controller. The interpreter receives the 
SIMATIC controller commands and executes these, including the kinematics 
transformation, via the robot mechanics. 


Advantages 


Programming a KUKA industrial robot using a SIMATIC S7-1500 controller with the 
KUKA.PLC mxAutomation block library in the TIA Portal offers the following 
advantages: 


e All programming of robots and plants is performed in the TIA Portal. Training in 
a robot manufacturer-specific development environment is not necessary. 


e The movement program of the robot is fully integrated into the plant control 
program and can be archived together with this program. 


e The robot cell can be fully integrated into the SIMATIC plant controller. 


e The operation of the robot can be integrated into the HMI user interface of the 
plant. 


e Diagnostic messages of the robot are sent to the SIMATIC controller where 
they can be further processed and displayed on the HMI user interface of the 
plant. 


e Remote access to the SIMATIC controller for service and maintenance is 
possible via standard functions and can be extended to the robot. 
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1.3 


Aim of this application example 


The application example provided here provides an example of how the KUKA.PLC 
mxAutomation block library in the TIA Portal is used and shows which functions are 
required to program and operate a KUKA robot using a SIMATIC controller. 


The application example is intended to familiarize you with the basic functions of 
the KUKA.PLC mxAutomation block library in the TIA Portal and to serve as a 
guide for decision-making and planning your own projects and user programs with 
a KUKA industrial robot. 


The functionality of the blocks from the KUKA.PLC mxAutomation block library is 
shown by means of the creation of three function blocks in which the following 
functions of the robot are programmed: 


e Switching on the robot (KukaControl) 
e Implementation of a simple pick & place movement (PickPlace) 
e Moving the robot on a circular path (Circle) 


The application example is suitable for programming a basic control of the robot in 
the SIMATIC controller. 


Based on this application example, a further example which shows the use of a 
KUKA industrial robot with an extended range of functions, including the required 
HMI user interface, can be requested from Siemens Robotics Support. For more 
information on this topic, refer to chapter 5.1 


A detailed description of the function and application of the KUKA.PLC 
mxAutomation block library can be found in the KUKA documentation for the 
KUKA.PLC mxAutomation library which can be found in chapter 5.4. 


Required knowledge 


1.4 


Basic knowledge of the creation of a user program on the SIMATIC S7-1500 in the 
TIA Portal or the hardware configuration is not taught in this application example, 
but is assumed. 


In addition, this application example is not an introduction to robotics. Basic 
knowledge of the application and the capabilities of an industrial robot are also 
required. 


Components used 


The application example was created with the following hardware and software 
components: 


Table 1-1: SIEMENS components 


Component Number Article number Note 
SIMATIC CPU S7-1516F 6ES7 516-3FN01-0ABO | Firmware version 2.6 


=e 


TIA Portal V15.1 


STEP 7 Professional 1 6ES7822-1AE05-0YA5 
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Table 1-2: KUKA components 


Component Number Article number Note 
KR C4 compact with 1 204-949 Robot controller 
Firmware V8.5 
KR 6 R700 SIXX (KR 1 205-456 Robot arm 
AGILUS) 
KUKA.PLC 1 253-517 Version: V3.0.2 
mxAutomation 
KUKA.PROFINET device | 1 244-976 Version: V4.1 


Consequently, the robot 
can be used as a 
PROFINET device. 


KUKA GSD file for KRC4 | 1 Version 2.33 
with Firmware V8.5 


This application example consists of the following components: 


Table 1-3 
Component File name Note 
Documentation 109482123 GettingStartedSRIKuka_DOC_V15_ | This document 


en.pdf 


TIA V15.1 Project 109482123 GettingStartedSRIKuka_PROJ_mx Example Program 
AV302_TIAV15.1.zip 
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2 Basics 


This chapter is intended to explain basic functions and background information for 
the use of a KUKA industrial robot in connection with the KUKA.PLC mxAutomation 
block library. 


2.1 Configuration of an industrial robot 


An industrial robot is generally composed of the following components: 


Figure 2-1: Configuration of a KUKA industrial robot 


Table 2-1 


1 


No. 


Component 


Manipulator 


Function 


The manipulator represents the actual 
robot mechanics, i.e. the kinematics, 
which executes the ordered commands. 


smartPAD programming handset 


Connecting cable/smartPAD 


Settings can be entered and checked 
on the robot controller using the 
smartPAD programming handset. 
Likewise, the robot can be moved 
manually and automatically using the 
programming handset. 


Robot controller 


Connecting cable/data cable 


Connecting cable/engine cable 


The robot controller coordinates the 
movements of the robot. The calculation 
of the coordinate transformation for the 
robot movements and the control of the 
robot axis motors occur in this 
controller. 

The robot controller may also contain 
the power units for the robot axis 
motors. 
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2.2 KUKA.PLC mxAutomation 


2.2.1 Overview 


The graphic below provides an overview of how the KUKA.PLC mxAutomation 
block library works. 


Figure 2-2: Functional overview of KUKA.PLC mxAutomation 


SIMATIC 
PLC 
PROFINET IE 


KUKA 
Robot Controller KR C4 
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Optional package KUKA.PLC mxAutomation 


The optional package for a KUKA industrial robot KUKA.PLC mxAutomation 
consists of two parts: 


e A block library for the programming of a KUKA industrial robot with a SIMATIC 
controller. 


e = Aninterpreter on the robot controller which interprets the commands of the 
function blocks from the SIMATIC controller and passes them on to the path 
planning of the robot controller. 


Program sequence 


2.2.2 


2.2.3 


2.3 


2.3.1 


In the figure, the robot program, which is based on the KUKA.PLC mxAutomation 
block library, is embedded in the program sequence of the machine program in the 
SIMATIC controller. The following functions of the robot program are executed with 
each program cycle: 


1. Reading of robot data. 


2. Assignment of robot movement via the function blocks of the KUKA.PLC 
mxAutomation block library. 


3. Writing of robot data. 
In the robot controller, the assigned robot movements are stored in the command 
buffer and - according to the FIFO principle - are transferred into the program 


memory of the robot controller, from where the robot movements are then 
executed. 


KUKA.PLC mxAutomation block library 


The KUKA.PLC mxAutomation block library provides various blocks for controlling 
a KUKA industrial robot. The desired functions of the KUKA robot can be controlled 
by simply calling the corresponding block from the block library. 

Calling a function block from the block library transfers the corresponding 
commands to the KUKA robot controller and interpreted there. 


Interpreter on the KUKA robot controller 


The interpreter on the KUKA robot controller accepts the commands of the function 
blocks from the KUKA.PLC mxAutomation block library in the robot controller, 
stores them in a buffer memory and processes the instructions in its own cycle. 


Configuration of the block library 


Block types 


The KUKA.PLC mxAutomation block library contains two types of movement 
blocks: 


e Blocks with the prefix "KRC_": 
These blocks are included in the block library for compatibility reasons and do 
not behave in accordance PLCopen standard. 


e Blocks with the prefix "MC_": 
These blocks are combined in their own program folder and contain the same 
movement functionalities. However, the inputs and outputs of the blocks 
behave according to PLCopen standard. 
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In this application example, only the PLCopen standard movement blocks will be 


discussed below. 


Note Blocks for administrative functions of the robot can still be found in the program 
folder of the KUKA.PLC mxAutomation block library. 


2.3.2 Block inputs and outputs 


The PLCopen standard movement blocks essentially have the following inputs and 


outputs: 


Figure 2-3: Example of a PLCopen movement block from the block library 


UFB995 


"MC_MoveDirectAbsolute” 


--== EN 

--- —= AxisGroupldx 
-- == Execute 

--- == Position 

--- == Velocity 


~-— Acceleration CommandAborte 


CoordinateSyste 
Im 


--- —= Approximate 
--- ==" QueueMode 


Table 2-2: Input and output parameters of the PLCopen movement blocks 


Interface Description 

Inputs 

AxisGroupldx Index of the axis group (as defined in 
chapter 3.4.1) 

Execute Starts / buffers movement at positive edge. 

Position Target position (data type depends on 
movement type) 

Velocity Velocity for path movement (unit varies 
depending on movement type) 

Acceleration Acceleration for path movement (unit varies 
depending on movement type) 

Approximation Blend parameters APO (see chapter 3.6.5) 
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QueueMode 


Interface 


Description 


Mode in which instructions are executed 
0 DIRECT 


e _ Instruction is executed directly by the 
submit interpreter of the KUKA robot 
controller. 


e This mode is not available for some 
function blocks. 


1: ABORTING 


e Instruction is immediately executed by 
the robot interpreter. Before this, all 
active movements and buffered 
instructions are aborted and the robot 
is brought to a halt. 


2: BUFFERED 


e Instruction is buffered. Buffered 
instructions are processed by the robot 
interpreter according to the FIFO 
principle. 


Outputs 


ComAcpt 


Instruction has been completely transferred 
and confirmed by the robot controller. 


ComBusy 


Instruction is currently being transmitted 
and has not yet been confirmed by the 
robot controller. 


Busy 


Function block has not yet been completely 
executed. 


ACTIVE 


Movement is currently being executed. 


Done 


Movement has been completed 
successfully. 


Aborted 


Instruction / movement aborted. 


Error 


Error during execution of the function block. 


ErrorlD 


Error number 

The assignment to the corresponding error 
message can be found in the KUKA manual 
"Siemens Library for KUKA.PLC 
mxAutomation" in the chapter "Messages". 
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3 Creating a program 


3 


3.1 


3.1.1 


Creating a program 


This chapter explains how the Example Program for the application example was 


set up. 
This chapter explains the following: 


e Integration of the robot in the hardware configuration of the TIA Portal project. 


e Integration of the KUKA.PLC mxAutomation block library. 
e Programming of the basic functions of the robot. 
e Programming of selected movement sequences of the robot. 


Hardware configuration 
Robot as PROFINET device 


The KUKA robot is integrated as a PROFINET IO device in the hardware 
configuration of the TIA Portal project. The robot is integrated via an additional 
GSDML file to be integrated into the TIA Portal which contains the hardware 
description of the robot and the possible data telegrams for the data exchange 
between the SIMATIC controller and the robot. 


Installing the GSDML file of the robot 


The GSDML file of the robot is usually supplied together with the robot, with the 
robot documentation, or can be obtained from KUKA Service. 


The GSDML file can then be integrated into the TIA Portal via the GSD file 
management function. 


Figure 3-1: Importing the GSDML file 
C:\Users\Siemens\Desktop\KUKA_BASIC_EXAMPLE_V15_1516F\KUKA_BASIC_EX 


YA Siemens - 


Project Edit View Insert Online | Options |Tools Window Help 


| 35 ry is Save project Ge x 35) 4 ? Settings onlir 


Support packages 


Manage general station description files (GSD) 


Devices 


Start Automation License Manager 


#| Show reference text 


~ _) KUKA_BASIC_EXAMPLE_V15_151¢ LL Global libraries d 


i Add new device Teamcenter > 


mn Devices & networks 


Select the GSDML file "KUKA-KRC4-ProfiNet". 
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3 Creating a program 


Figure 3-2: Installing the GSDML file 


Manage general station description files 


Installed GSDs 


GSDs in the project 


Source path: | C:\Users|Siemens\Desktop\KUKA_BASIC_EXAMPLE_V15_1 516FlAdditionalFiles\GSD 


() File 


Content of imported path 


() GSDML-V2.25-KUKA-Roboter-GmbH-KRC-next-Device-V1.0-20111219.xml 
a} GSDML-V2.25-KUKARoboterGmbH-KUKARobotController-201 30808 xml 
FG 7 24 KI AKRCA-PrnfiNet 2 9-9N14NaNR wml 
8B 


tl 


Version Language 

V2.25 English, Germ... ... 
V2.25 English, Germ... ... 
V2 321 Ennlich Germ 


The selection of the GSDML file depends on the PROFINET version installed on 
the robot controller. The following table shows the various PROFINET versions 
with their associated GSDML file: 


Table 3-1 
PROFINET GSDML file required Name of the device (in 
version GSDML file) 
1.0 GSDML-V2.25-KUKA Robot KUKA KRC nexxt 
GmbH-KR C4-Device- Device V8.1 
V1.0-20121030.xml 
2.0, 2.1, 2.2 GSDML-V2.25-KUKA Robot KUKA KRC nexxt 
GmbH-KR C4-Device- Device V8.1 
V1.0-20121030.xml KUKA KRG nexxt 
Device V8.2 
2.3 GSDML-V2.31-KUKA-KRC4- KRC4- 
PROFINET_2.3-20140704.xml PROFINET_2.3 
3.0 GSDML-V2.25-KUKA Robot KUKA KRC nexxt 
GmbH-KR C4-Device- Device V8.1 
V1.0-20121030.xml KUKA KRG nexxt 
Device V8.2 
KR C4 Device 
V8.3 
3.1 GSDML-V2.25-KUKARoboterGmbH- KR C4 Device 
KUKARobotController- V8.3 
20130808.xml 
3.2 GSDML-V2.31-KUKA-KRC4- KRC4-ProfiNet_3.2 
ProfiNet_3.2-20140908.xml 
3.3 GSDML-V2.32-KUKA-KRC4- KRC4-ProfiNet_3.3 
ProfiNet_3.3-20161027.xml 


$7-1500 / KUKA mxAutomation 


Entry-ID: 109482123, V1.5, 09/2020 


15 


© Siemens AG 2020 All rights reserved 


3 Creating a program 


ProfiNet_4.1-20170612.xml 


PROFINET GSDML file required Name of the device (in 
version GSDML file) 
4.0 GSDML-V2.32-KUKA-KRC4- KRC4-ProfiNet_4.0 
ProfiNet_4.0-20170412.xml 
4.1 GSDML-V2.33-KUKA-KRC4- KRC4-ProfiNet_4.1 


Note The older GSDML files can also be used with PROFINET 3.1 and 3.2. In this 
case, the PROFINET settings 3.0 apply for PROFINET 3.1. In PROFINET 3.2, 
the PROFINET 3.1 settings apply. 


Further information on the selection of the GSDML file can be found in the KUKA 
documentation for the KUKA PROFINET controller identified in chapter 5.4. 


3.1.3 Integrating a robot into the hardware configuration 


After integrating the GSDML file into the TIA Portal, the KUKA KR C4 robot 
controller in the corresponding firmware version can be integrated into the 
hardware configuration of the TIA Portal by means of drag & drop. 


Double-clicking on the robot controller in the hardware configuration allows further 
configuration of the components for data exchange with the SIMATIC controller. 


In order to enable the exchange of the data required to control the robot with the 
SIMATIC controller, the necessary data exchange telegram must still be configured 
in the hardware configuration with the robot controller. For this, the telegram for 
2032 digital inputs and outputs must be integrated from the telegram selection into 
the robot controller component of the hardware configuration using drag & drop. 
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3 Creating a program 


Figure 3-3: Selection of the KUKA robot from the hardware catalog 


avenge 


Options 
= 

v | Catalog 

<Search> {init | {int | 
AFilter Profile: [<All> |+] 
> [jg Controllers 

> [HM 

» i] PC systems 


> [i Drives & starters 
» [ig Network components 
» [jg Detecting & Monitoring 
> [ig Distributed 1/0 
> [ig Power supply & distribution 
> [i Field devices 
v ir] Other field devices 
» [i Additional Ethernet devices 
> [jg PROFINETIO 
» i Drives 
» i Encoders 
» [ig Gateway 
~ {lio 
> [i KUKA Roboter GmbH 
> [i KRC4-ProfiNet_3.2 
» [i KRC4-ProfiNet_3.3 
» [i KRC4-ProfiNet_4.0 
> [i KRC4-ProfiNet_4.1 


> [ig KUKA 
» ir] KUKA Robot Controller 
> [ig Ident Systems 
» [i PLCs & CPs 
» i Sensors 
> [ig PROFIBUS DP 


KUKA XAMPLE_V1 age = RCA [KRCA-ProfiNet_4.1] 


Figure 3-4: Data exchange between SIMATIC controller and the robot 


Device: 

KRC4-ProfiNet_4.1 
Article no.: 0x300 | 
Version: (GSDML-V2.33-KUKA-KRC4-PROFINET 4.1] ¥ | 
Description: 
PROFINET IO 


[i Topology view Joh Network view [BY Device view | 


dp (race (xncerroferst] |e) So RY Gli [ 8) Qe a | Device overview | 
we ited et see teddress Qaddress Type = acter Sommers Comment 
‘ > Interface - ak RCS 
aa . 2032 digital in-and outputs... 0 2 2000... 2000. 2032 digitel in-an.. KUKA Device 102032 
Figure 3-5: Data telegram 
Device overview 
Pe) Module [Rack |Slot_—/laddress _Qaddress Type Article no. | Firmware 
~ KRC4 oO oO KRC4-ProfiNet_4.1 0x300 V4.1 
> Interface1 oO ox1 KRC4 
oO a 
2032 digital in-and outputs... 0 2 2000...... 2000...... 2032 digital in-an... KUKA Device 102032 
Note When configuring the data telegram, note the start address of the peripheral data 


area for the data exchange with the robot. This address is needed later during 


programming for reading and writi 


$7-1500 / KUKA mxAutomation 
Entry-ID: 109482123, V1.5, 09/2020 


ng the robot data. 


17 


© Siemens AG 2020 All rights reserved 


3 Creating a program 


Note 


3.1.4 


Note 


Optionally, additional telegrams or telegram extensions for optional functions, 
such as Safety Integrated, can be integrated into the robot controller. 
Further information on this can be found in chapter 4.2. 


The additional telegrams can also be integrated into the robot controller by 
means of drag & drop in the hardware configuration of the TIA Portal. 


Connecting the SIMATIC S7 and the robot 


Finally, the robot controller and the SIMATIC controller must be connected to each 
other via PROFINET connection. For this purpose, suitable IP addresses must be 
assigned to the individual devices or in the hardware configuration. 


Optionally, an HMI device, which can be used to control and monitor the robot 
functions, can also be integrated into the configuration. 


Figure 3-6: Connection of robots, SIMATIC controller and HMI 


KUKA_BASIC_EXAMPLE_V15_1516F > Devices & networks 


& Topology view ba Network view [ix Device view | 


Fe Network) £2 Connections [Hii connectio Tr] GQ Relations f° SB Ey (ca Qs =| 


KRC4 a 
KRC4-ProfiNet_... KUKA 
PLC_1 


HML1 PLC_1 


TP1500 Comfort [| CPU 1516F-3 PN... 


til 


Controlling several robots using a SIMATIC S7 


With a suitable SIMATIC controller, up to five KUKA industrial robots can be 
simultaneously controlled using the KUKA.PLC mxAutomation block library. 
Demarcation is defined in the library. The retentive memory is the primary 
separating factor in the SIMATIC controller. The greater the number of robot 
positions which have to be stored, the more retentive memory is required. 
However, the remanence memory can be enlarged by a corresponding power 
supply module, which would enable even smaller controllers to store more robot 
positions and theoretically control more than five robots. 


In the data block supplied with the KUKA.PLC mxAutomation block library, five 
data arrays are provided for data exchange between the SIMATIC controller and 
the robot. 


The data are assigned to the corresponding robot via the defined telegram 
addresses in the IO area of the SIMATIC controller, as defined in the hardware 
configuration. 


The function blocks and robot functions are assigned to the individual robots in the 
user program via the block input AxisGroupldx, which represents the index of the 
data array in the data block MxADBRobots. 


However, this functionality will be explained in more detail in the following chapters. 
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3 Creating a program 


3.2 


3.2.1 


Note 


3.2.2 


Figure 3-7: Data pool for five robots in the data block MxADBRobots 
fark PRRBGBE LE 


MxADBRobots 
Name Data type Offset Start value F 

1 @ ~ Static 

2 aql= ~ KRC_AxisGroupRefarr Array[1..5] of AXIS_GROUP_REF* _—[|| ¥| 0.0 

3 a = > KRC_AxisGroupRefArr[1] ] “AXIS_GROUP_REF* 0.0 

4 <4 = >» KRC_AxisGroupRefArr[2] "AXIS_GROUP_REF* 736.0 
5 a = >» KRC_AxisGroupReférr[3] “AXIS_GROUP_REF* 1472.0 
6 a = > KRC_AxisGroupRefArr[4] “AXIS_GROUP_REF™ 2208.0 
7 <4 = >» KRC_AxisGroupRefArr[5] “AXIS_GROUP_REF* 2944.0 
6’ as PLC_SYS_TICK_CNT Dint 3680.0 
Ss a. PLC_TICKS_PER_SEC Int 3684.0 


Importing a block library 


Unpacking a block library 


Before you can use the KUKA.PLC mxAutomation block library in your user 
program, the block library function blocks must be transferred to the TIA Portal 
project. 

The KUKA.PLC mxAutomation block library for the TIA Portal is supplied as a 
global library from which all block library function blocks can be transferred to a TIA 
Portal project by means of drag & drop. 


To make the global library usable for the TIA Portal, extract the global library 
archive to a convenient location on the hard drive of your programming device. 


The KUKA.PLC mxAutomation block library for the TIA Portal can be requested 
from the KUKA Customer Service team or the KUKA Roboter GmbH hotline and 
must be compatible with the interpreter on the robot controller. 


Opening a block library 


After unpacking, you can open the global library via the access functions of the TIA 
Portal. 


Figure 3-8: Opening a block library 


¥ | Glohal libraries 

uf & fa ty Fey 
> LLJ Buttons-and-Switches 

> LL] Long Functions 

> LL Monitoring-and-control-objects 

> LL] Documentation templates 

> LU wWinac_mp 


The KUKA.PLC mxAutomation block library is saved as a copy template in the 
global library. 
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3 Creating a program 


3.2.3 


Transferring blocks to the user program 


The KUKA.PLC mxAutomation block library can be transferred to your user 
program by simple drag & drop from the global library. Both the necessary PLC 
data types and the function blocks must be transferred from the copy templates of 
the global library to your TIA Portal project. All templates are in the "Master copies" 
folder. 


e First, drag the "User Datatypes" object to the "PLC Data Types" folder in your 
project. There, a subfolder is automatically created which contains all PLC data 
types of the KUKA.PLC mxAutomation block library. 


e Then drag the remaining objects into the "Program blocks" folder of your TIA 
Portal project. There, a subfolder is automatically created which contains all 
function blocks of the KUKA.PLC mxAutomation block library. 


Figure 3-9: Copying templates of the mxAutomation library 
v | Global libraries 
ge sense 2) E) [Al is 


> LL] Buttons-and-Switches 

> LL) Drive_Lib_s7_1200_1500 
> LU Drive_Lib_S7_300_400 

> LL Energy Suite 

> LL Long Functions 


> LL Monitoring-and-control-objects 


» Languages &resources 


All necessary data types and function blocks of the KUKA.PLC mxAutomation 
block library are now included in your TIA Portal project. The functions of the block 
library can now be used in your user program. 
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3 Creating a program 


3.3 Basic program structure 


The graphic below shows the basic structure of the Example Program for the robot. 


Figure 3-10: Schematic representation of the program sequence 


The complete robot program is summarized in a function (FC) for better structuring. 
In this FC, the necessary blocks for the robot from the KUKA block library and 
additional function blocks (FB) are called which contain special movement 
programs for the robot. 


The function "SiemensKuka" has the following structure: 


Note 


Reading of the robot data via the "KRC_ReadAxisGroup" block. 
Execution of the basic robot functions via the "KukaControl" block. 


Calling a block to execute a simple pick & place movement. This movement is 
summarized in the "PickPlace” block. 


Calling a block to execute a simple circular movement. This movement is 
summarized in the "Circle" block. 


Reading of the robot data via the "KRC_WriteAxisGroup" block. 


The "SiemensKuka" function enables better structuring and should be regarded 
as acall-FC. This means that it contains accesses to global DBs and thus cannot 
be used as a library element. 
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3 Creating a program 


3.4 


"SiemensKuka" block 


Create a new block in the program blocks area by right-clicking. 


Figure 3-11: Adding a new block 


Project tree 


Devices 


Pal 


y _]) KUKA_BASIC_EXAMPLE_V15_1516F a 
i Add new device iT] 
am Devices & networks 

> [jm PLC_1 [CPU 1516F-3 PN/DP] 
BY Device configuration 
| Online & diagnostics 


> |g System blocks ; 
» ie" Technology objects a) 


> [A Freravohierts 


Select "Function", assign a name and determine the desired programming 
language. 


Figure 3-12: Creating a new function 
Add new block IX 


Name: 
SiemensKuka } 


" Language: [Lap dw 
- Number: - IE 
Organization © Manual 
— @) Automatic 


f- Description: 


Functions are code blocks or subroutines without dedicated memory. 
Function block 


Data block 


more... 


> | Additional information 


{4) Add new and open a | Cancel 


Open the newly created function and add the blocks "KRC_ReadAxisGroup" 
(FB953) and "KRC_WriteAxisGroup" (FB954) from the KUKA.PLC mxAutomation 


library. 
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3 Creating a program 


3.4.1 


Note 


3.4.2 


CAUTION 


KRC_ReadAxisGroup 


The block "KRC_ReadAxisGroup" (FB953) from the KUKA.PLC mxAutomation 
library allows the reading of data from the robot controller into the internal data 
storage of the KUKA.PLC mxAutomation block library in the SIMATIC controller. 


This enables the provision of data from the robot or robot controller to the user 
program in the SIMATIC controller for the other blocks from the KUKA.PLC 
mxAutomation library. 


Figure 3-13: Reading data from the robot 


SF B953 
"KRC_ReadAxisGroup” 
--== EN 
| —= AxisGroupidx Error — --- 
2000 — |nputStartByte ErroriD — --- 
--- = FirstScanBit ENO — 


The assignment of data to the corresponding robot connected on the SIMATIC 
controller occurs via the input "AxisGroupldx" which corresponds to the index of the 
data array in the data block "MxADBRobots" and the input "InputStartByte", in 
which the telegram address of the robot is sent from the I/O area of the SIMATIC 
controller to the block. 


For the input "InputStartByte", choose the start of the address range configured in 
chapter 3.1.3 (here: 2000). 


The index of the input "AxisGroupldx" can then be used to assign the robot to the 
program blocks of the robot program in the SIMATIC controller. 


KRC_WriteAxisGroup 


After the robot program has been processed in the SIMATIC controller, the block 
"KRC_WriteAxisGroup" (FB954) from the KUKA.PLC mxAutomation library 
transfers the data from the data block "MxADBRobots" to the robot defined by the 
telegram address. 


Figure 3-14: Writing data to the robot 


TFB954 
"KRC_WriteAxis Group™ 


--==EN Error — --- 
| —= AxisGroupidx ErrorlD — --- 
2000 — QutputStartByte ENO — 


The inputs of this block are interconnected according to the function block 
"KRC_ReadAxisGroup" from chapter 3.4.1. 


When entering the telegram addresses of the robot for reading and writing 
the robot data, make sure that they are correctly assigned to the desired 


robot. 
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3 Creating a program 


3.4.3 Function blocks for robot movements 


Now create the three function blocks "KukaControl", "PickPlace" and "Circle" in the 
same ways as the function block "SiemensKuka". 


Figure 3-15: Adding the function blocks 


Add new block IX 

Name: : 

Kuka Control } 

Language: | FBD |+| 

— ir 

- Number: eo > 

Organization © Manual 
block © Automatic 


Description: 


Function blocks are code blocks that store their values permanently in instance data blocks, 
so that they remain available after the block has been executed. 


= 


Function 


us. 


Data block 


more... 


> | Additional information 


{4) Add new and open [ OK | | Cancel ] 
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3 Creating a program 


3.5 "KukaControl" function block 


The function block "KukaControl" contains basic functions of the robot: 


Table 3-2: "KukaControl" function overview 


Initialization 


Functionality 


Function block 
KRC Initialize (FB930) 


Diagnostics data 


KRG ReadMXAStatus (FB906) 
KRC ReadKRCError (FB910) 
KRC_ Diag (FB950) 

KRC ReadMXAError (FB908) 


KRC MessageReset (FB909) 


Activation of the Automatic External 
interface and switch-on of the robot 


KRC_AutomaticExternal (FB900) 
KRC_AutoStart (FB983) 


Control override 


KRC_ SetOverride (FB911) 


position. 


Current Cartesian position and current axis 


KRC_ ReadActualPosition (FB901) 
KRC_ ReadActualAxisPos (FB902) 


Move robot in jog mode 


KRC_Jog (FB975) 


Teach position 


KRC_TouchU (FB957) 
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3 Creating a program 


The function blocks are called as shown below: 


Figure 3-16: "KukaControl" program sequence 
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3 Creating a program 


Create the input variable "axisGroupldx" of data type INT. This variable 
communicates the identity of the robot to be controlled to all subsequent function 
blocks. 


Figure 3-17: Creating the input variable "AxisGroupldx" 


KUKA_BASIC_EXAMPLE_V15_1516F > PLC_1 [CPU 1516F-3 PN/DP] >» Program blocks >» SIEMENS_APPLICATION_EXAMPLE > KukaCont 


Ades ESA Sas Bt er SR Cotas ers Ud &F & 


KukaControl 
Name Data type Default value Retain Accessible f... Write... Visible in... Setpoint Supervis.... Commen 
1 <@ Y Input 
2a" axisGroup Int fai Non-et... [¥ 7) 7) m7) 


3 << Y Output 


3.5.1 KRC_Initialize 


Before data can be exchanged between the SIMATIC controller and the robot, the 
KUKA.PLC mxAutomation interface must be initialized. For this purpose, call the 
block "KRC_ Initialize" (FB930). 


The successful initialization of the interface is reported back to the user program 
via the output "Done". 
In addition, the block returns the following information: 
e Serial number of the robot controller on the output "KRC_Serial" 
e Interpreter version at the outputs: 

"KRC_Major " 

"KRC_Minor" 

"KRC_ Revision" 
e Version of the block library at the outputs: 

- "PLC_Major" 
"PLC_Minor" 
"PLC_ Revision" 


Figure 3-18: Initializing the MXA interface 
4FB930 
"KRC_Initialize” 
Done — --- 
Error — --- 
ErroriD ~~ --- 
KRC_Serial — --- 
KRC_Major — --- 
KRC_Minor — --- 
KRC_Revision ~~ --- 
PLC_Major — --- 
PLC_Minor —— --- 
--—= EN PLC_Revision — --- 
#axisGroup — AxisGroupldx —ENO— 
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3 Creating a program 


3.5.2 


3.5.3 


Example 


KRC_ReadMXAStatus 


Now call the function block "KRC_ReadMXAStatus" (FB906) to determine the 
current status of the data interface of the KUKA.PLC mxAutomation library. 


Figure 3-19: Querying interface status 


%B906 
"KRC_ReadMXAStatus” 


Status —— --- 

Error — --- 

_— a ErroriD — -- 
#axisGroup — AxisGrouplidx ENO — 


The status information is reported back via the PLC data type "MXA_STATUS" on 
the "Status" output of the block as INT. The output can assume the following 
states: 


Table 3-3: Values of the output "Status" 


Value Name Description 
0 Invalid No function blocks can be processed 
1 Error An mxA error message is active and must be 


acknowledged with the function block 
KRC_MessageReset. 


2 ProgramStopped Robot interpreter is not active. 

3 StandBy Robot interpreter is active and waiting for instructions. 
4 Executing Robot interpreter is active. 

5 Aborting Robot has been stopped and instructions aborted. 


KRC_ReadKRCError 


The function block "KRC_ReadKRCError" (FB910) is used to determine the current 
error status of the robot controller. 


The robot controller contains a message buffer for several error messages. Up to 
ten messages can be read out from the message buffer simultaneously by calling 
the function block "KRC_ReadKRCError". 

In addition, the block also contains an offset input via which the remaining error 
messages can be read out in groups of ten messages each. 


If there are 15 messages in the message buffer, the function block 
"KRC_ReadKRCError" must be called twice as follows: 


e Call with offset 0 to read message 1 to 10 
e Call with offset 6 to read message 6 to 15 


S7-1500 / KUKA mxAutomation 
Entry-ID: 109482123, 1.5, 09/2020 28 


© Siemens AG 2020 All rights reserved 


3 Creating a program 


Note 


3.5.4 


Figure 3-20: Reading out robot controller error messages 


4FB910 
*KRC_ReadKRCError™ 

Done — --- 
Error — --- 
ErroriD —— --- 
STOPMESS — --- 
MessageCount — --- 
Messagel — -- 
Message2 — --- 
Message3 ~~ --- 
Message4 ~~ --- 
Message5 —— --- 
Message6 — -- 
Message7 —— --- 
== EN Message8 — -- 
#axisGroup — AxisGroupidx Message9 — --- 
false —= ExecuteCmd Message10 — --- 

o——~ Offset ENO — 


Messages can only be acknowledged when the robot is at a standstill. 


KRC_Diag 


Now call the function block "KRC_Diag" (FB950) to determine various diagnostic 
data of the robot controller or the submit interpreter for processing the commands 
of the function blocks from the KUKA.PLC mxAutomation block library on the robot 
controller. 


The following diagnostic data are provided by the function block in the SIMATIC 
controller: 


e Quantity of buffered instructions of the function blocks from the KUKA.PLC 
mxAutomation block library in the robot controller. 


e Heartbeat signal of the submit interpreter, which processes the commands of 
the function blocks from the KUKA.PLC mxAutomation library on the robot 
controller, as vital sign monitoring. 


e Current, shortest, longest and average cycle time of the submit interpreter. 
e Error number of the robot interpreter 

e Error number of the submit interpreter 

e Error number of the PLC in the robot controller 


The ShowTrace input activates the display of the active function blocks in the 
message window of the KUKA smartHMI. 


The MaxSubmitCycle input is used to define the maximum cycle time of the submit 
interpreter. If the time is exceeded, the release is canceled, and the robot can no 
longer move. 
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Figure 3-21: Query diagnostic signals of the robot controller 


FB950 
"KRC_Diag” 
Valid — --- 
QueueCount — --- 
PosActValid — --- 
BrakeActive — --- 
SubmitHeartbe 
i —_— 
SubmitCyc_Act — --- 
SubmitCyc_Min — --- 
SubmitCyc_Max — --- 
SubmitCyc_Avg — --- 
ActivePosOrderl 
D—... 
ActiveOrderlIDB — --- 
Avg_Duration — --- 


ProconosHeart 
beat — -.. 
ProconosCyc_ 
ProconosCyc_ 
Min — ... 
ProconosCyc_ 
a 
ProconosCyc_ 
Avg — --- 
ErrorlD_RI —— --- 
ErrorlD_S| — --- 
--—= EN ErrorlD_PLC — --- 
#axisGroup — AxisGrouplidx ErrorlD_PCOS — -.- 
false — ShowTrace Error — --- 
MaxSubmitCycl EtroniD — -- 
Oo—e ENO — 


3.5.5 KRC_ReadMXAError 


The function block "KRC_ReadMXAError" (FB908) can be used to determine the 


current error status of the mxA interface of a robot. The cause of the error is output 
as an error number by the "ErrorlD" output. Only error messages generated by the 


mxA interface are displayed. 


Figure 3-22: Reading out of KUKA.PLC mxAutomation interface error messages 


4FB909 
"KRC_MessageReset™ 
= EN Error — --- 
#axisGroup — AxisGroupidx ErrorlD — --- 
‘olse —= MessageReset ENO — 


$7-1500 / KUKA mxAutomation 
Entry-ID: 109482123, V1.5, 09/2020 


30 


3 Creating a program 


© Siemens AG 2020 All rights reserved 


3.5.6 KRC_MessageReset 


Call the function block "KRC_MessageReset" (FB909) to acknowledge the current 
error status of a robot. 


Figure 3-23: Acknowledging error messages of the robot 


“FB909 
"KRC_MessageReset™ 
EN Error — --- 
#axisGroup — AxisGroupldx ErroriD — --- 
‘alse —= MessageReset ENO — 
Note Robot controller error messages can only be acknowledged when the robot is at 
a standstill. 
3.5.7 KRC_AutomaticExternal 


To establish communication between the SIMATIC controller and the robot 
controller, the interface "Automatic External" must be activated with the function 
block "KRC_AutomaticExternal" (FB900) and the signals of the interface must be 
read. This block may only be called once per axis group. 


Figure 3-24: Activating the Automatic External interface 


TFB900 
"KRC_AutomaticExternal 

Valid — --- 
RC_RDY1 — --- 
ALARM_STOP — --- 
USER_SAFE — --- 
PERI_RDY — --- 
ROB_CAL — --- 
1O0_ACTCONF — - 
STOPMESS — --- 
EN INT_E_STOP — --- 
#axisGroup — AxisGroupldx PRO_ACT — --- 
true == MOVE_ENABLE APPL_RUN — --- 
false ——— CONF_MESS PRO_MOVE —— --- 
‘ase —= DRIVES ON ON_PATH — --- 
true —= DRIVES_OFF NEAR_POSRET — --- 
fais == EXT_START ROB_STOPPED — --- 
‘else —= RESET 11 — --- 
true —= ENABLE_T1 132 — -- 
true == ENABLE_T2 aa — 
true —= ENABLE_AUT EXT — --- 

true — ENABLE_EXT ENO — 


To enable activation of the robot, the inputs of this block must be connected as 
shown. 
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Table 3-4: Important inputs of the function block "KRC_AutomaticExternal" 


Input Description 

AxisGroupldx Index of the axis group 

MOVE_ENABLE TRUE = release for the robot 

DRIVES_OFF TRUE = deactivation of robot drives 

ENABLE_T1 TRUE = release for T1 mode 
MOVE_ENABLE suppressed if release not 
present 

ENABLE_T2 TRUE = release for T2 mode 
MOVE_ENABLE suppressed if release not 
present 

ENABLE_AUT TRUE = release for AUT mode 
MOVE_ENABLE suppressed if release not 
present 

ENABLE_EXT TRUE = release for EXT mode 
MOVE_ENABLE suppressed if release not 
present 


All unnamed inputs are set by the block "KRC_AutoStart" and can retain their 
default values. 


3.5.8 KRC_AutoStart 


The function block "KRC_AutoStart" (FB983) arranges the signals of the interface 
"KRC_AutomaticExternal" in the correct sequence to start the robot. 


If the function block reports an error, the robot is not switched on and the output 
"Error" becomes active. The error code of the current error message can be read 
on the "ErrorlD" output. The assignment to the corresponding error message can 
be found in the KUKA manual "Siemens Library for KUKA.PLC mxAutomation” in 
the chapter "Messages". 


Figure 3-25: Starting the robot 


UFB983 
"KRC_AutoStart” 
Busy — --- 
DispActive — --- 
ResetValid — --- 
--—== EN Error —— --- 
#axisGroup — AxisGrouplidx ErrorlD — --- 
Te iS& ——= ExecuteReset ENO — 


The input "ExecuteReset" resets the program and aborts all buffered instructions in 
the robot controller. 
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3.5.9 


KRC_SetOverride 


The function block "KRC_SetOverride" (FB911) defines the percentage override of 
the programmed velocity: 


e For axis-related movement commands, the override acts on the specified axis 
velocity. 


e For path-related movement commands, the override acts on the specified path 
velocity. 


The following example is provided to explain this connection in more detail. In the 
figure, the maximum velocity, the programmed velocity and the resulting velocity 
with the override are given as a percentage of the maximum velocity. 


Figure 3-26: 50% override at 50% programmed velocity 


Max. velocity 


Programmed velocity 


Override: 50% 


Resulting velocity 


Velocity 


25% 50% 100% 


If a travel command is defined at half the maximum possible velocity, the override 
refers to this value. An override of 50% would therefore set the velocity of the robot 
to a quarter of the maximum possible velocity. 


Figure 3-27: Setting an override 


4FB911 
"KRC_SetOverride” 


Valid — -- 

ActualOverride — --- 

== EN Error — --- 

#axisGroup — AxisGroupldx ErrorlD — -.- 
2—— Override ENO — 
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3.5.10 KRC_ReadActualPosition 


The function block "KRC_ReadActualPosition" (FB901) reads out the Cartesian 
position of the tool tip with respect to the currently selected coordinate system. 


Note The "KRC_ReadActualAxisPos" (FB902) block must be used to read the position 


of the individual axes of the robot. 


Figure 3-28: Cartesian robot position 


X ¥ 


Figure 3-29: Reading out the tool position in the Cartesian coordinate system 
%B901 
"KRC_ReadActualPosition” 
Valid — --- 


= EN IPOMode — --- 
#axisGroup — AxisGroupldx ENO — 


The current position in the defined structure "E6POS" is output via the "Position" 
output. This contains all the individual values for the position in space and the 


rotation around the coordinate axes which are output at the outputs X to Z and A to 


C as well as Status and Turn. 


The Tool and Base outputs are used to output the currently active tool and the 
number of the currently selected coordinate system. 
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CAUTION 


A describes the rotation about the Z-axis 
B describes the rotation about the Y-axis 
C describes the rotation about the X-axis 


The outputs A, B and C describe the rotation around the individual 
coordinate axes, whereby the following assignments must be observed: 


The values Status and Turn are bit fields and serve to enable a more precise 
specification of the robot alignment at the current position with Cartesian position 
specification. The values thus describe the exact axis positions of the robot. 


Status is described by three bits: 
e Overhead is TRUE if the robot is mounted overhead. 


e Bits 1 and 2 are TRUE if the respective axis has an axis position of less than 


0°. 


Table 3-5: Calculation of Status 


Parameters Bit Status S 
Overhead 0 S=S+1 
Axis A3 1 S$=S+2 
Axis A5 2 S$=S+4 


Turn is described by 6 bits. The respective bit is TRUE if the corresponding axis 
has an axis position of less than 0°. 


Table 3-6: Calculation of Turn 


Parameters Bit Turn T 
Axis A1 0 TaTe1 
Axis A2 1 T=T+2 
Axis A3 2 T=T+4 
Axis A4 3 T=T+8 
Axis A5 4 TeTa46 
Axis A6 5 T=T+32 


Example 


The following example is intended clarify the calculation of Status and Turn. The 
robot is mounted on the ground and provides the following axis positions. This 

results in the following values for Status and Turn, with the start values for Status 
and Turn each being zero: 


Table 3-7: Example for the calculation of Status and Turn 


Parameters 


Position 


Status bit 
field 


Status 
(S = 0) 


Turn bit 
field 


Turn 
(T = 0) 


Overhead Floor-mounted 0 0-1=0 

Al -20° 1 1-1=1 

A2 -10° 1 1:2=2 
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Parameters Position Status bit Status Turn bit Turn 
field (S = 0) field (T = 0) 
A3 +5° 0 0-4=0 
A4 +40° 0 0-8=0 
A5 -30° 1 1-16=16 
A6 -50° 1 1-32=32 
Resulting values 100 Sum = 4 110011 Sum = 51 


For the axis positions described, this results in an S = 4 andaT = 51. 


3.5.11 


KRC_ReadActualAxisPos 


The function block "KRC_ReadActualAxisPos" (FB902) reads out the current 
positions of the robot axes. 


Figure 3-30: Robot axis positions 


A4 


Figure 3-31: Reading the robot axis positions 


--— EN 


4FB902 


"KRC_ReadActualAxis Pos” 


#axisGroup — AxisGroupldx 
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3.5.12 


The position of the robot axes in the defined structure "E6AXIS" is output via the 
"AxisPosition" output. This contains all individual values which are pending at the 
outputs Ai to A6 and E1 to E6. 


The outputs E1 to E6 represent the current position of the additional axes which 
can also be influenced by the robot controller. 


KRC_Jog 


The robot can be moved in jog mode via the function block "KRC_Jog" (FB975). 


The "MoveType" input can be used to select whether the robot axes should be 
traversed directly, i.e. axially, or whether the Tool Center Point (TCP), i.e. the tool 
tip, should be moved in the Cartesian coordinate system. 


If the function is called during a movement, all active and buffered commands are 
aborted, the robot is decelerated and then the movement is executed. 


The function can simultaneously move several axes of the robot(s) along several 
coordinate axes. 


Figure 3-32: Moving the robot by hand 


YFB975 
*KRC_Jog™ 
--== EN 
#axisGroup — AxisGroupidx 

2 — Move Type 

d= Velocity 

J—= Acceleration 

CoordinateSyst 
em 
0.0 —= Increment 

false — A1_XP 
alse — AIX M 
false —— Az YS? 
false — AZ Y_M 
alse —— A3_Z P 
false —— A3_ZM 
false —o A4_AP 
false — A4_ AM 
falsce— AS5_BP 
alse —= AS BM 
alse == AGB C P 
sISe—= AGB_CM 
alse — E1_P 
false — E1M 
false —= E2 P 
false —E2 M 
false — £3 _P 
false —= E3_M Busy — -- 
false — E4 P Active — -- 
false ——E4 M Done — --- 
flse— ES P Aborted — --- 
false —— E5 M Error — --- 
false —— EG P ErroriD —~ --- 
false —= E6_M ENO — 
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3.5.13 


Table 3-8: Selected inputs of the function block "KRC_Jog" 


Input Description 

MoveType Set movement type: 
0 Axis-specific 
1: Cartesian 

Velocity Velocity in % of the maximum value 
specified in the machine data 

Acceleration Acceleration in % of the maximum value 
specified in the machine data 

CoordinateSystem Coordinate system to which the coordinates 
of the target position refer. 

A1i_X_P Movement instruction 

A1 XM The movement is started on a rising edge 


and stopped on a falling edge. 

re The inputs for the axes A1 to A6 are 
A2_Y_M assigned twice with the coordinates, e.g. A1 
with X, A2 with Y etc. 

The inputs ending with P (e.g. A2_Y_P) 
move in a positive direction. The inputs 
ending with M (e.g. A3_Z_M) move ina 
negative direction. 


E6_M 


KRC_TouchUP 


The function block "KRC_TouchUP" (FB957) teaches the current position of the 
robot. 


Figure 3-33: Teaching in a position 


FB957 
"*KRC_TouchUP” 
--==EN Done — --- 
#axisGroup — AxisGrouplidx Error — --- 
false —= ExecuteCmd ErrorlD — --- 
2 —= Index ENO — 


The position and an identifier for the coordinate system to which the position refers 
are stored in the data block "MxADBPosition" (DB904). 


The storage location of the data in the position array of the data block is defined in 
the "Index". The data block is located in the block library in the directory 
KUKA_mxAutomation/mxA_SystemBlocks. 
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Figure 3-34: Data block "MxADBPosition" 


~ [Es] 10_KUKA_mxAutomation_V2.1.3 
> [E:] Function Blocks 
> [=] mxA_SystemBlocks 

ak mxA_GetlO_BOOL [FC908] 
ai mxA_GetlO_BYTE [FC911] 
ai mxA_GetlO_DINT[FC913] 
ai mxA_GetlO_INT[FC912] 
ai mxA_GetlO_NIBBLE [FC909] 
aM mxA_GetlO_REAL [FC915] 
ait mxA_GetlO_SINT[FC910] 
ai mxA_GetOrderState [FC905] 
ai mxA_ME_TO_REAL [FC990] 
ai mxA_ResetCommand [FC906] 
ai mxA_ValuesToAPO [FC904] 
ai mxA_ValuesToCOORDSYS [FC903] 
dit mxA_ValuesToE6AXIS [FC900] 
ai mxA_ValuesToE6POS [FC901] 
ai mxA_ValuesToFRAME [FC902] 
iF mx4_WritelO_BOOL [FC917] 
3 mxA_WritelO_BYTE [FC918] 
2M mxA_WritelO_DINT [FC920] 
2M mxA_WritelO_DWORD [FC923] 
ak mxA_WritelO_REAL [FC925] 
2k mxA_WritelO_WORD [FC924] 
at REAL_TO_BOOL [FC950] 
ai mxA_ExecuteCommand [FB955] 
i R_TRIG_2 [FB990] 


ar ICSstlicunr uncuen poss] 
g \MxADEPosition [DB904] 


Se 


— 
7 [Es] 11_OpenPLC_KUKA_mxAutomation_V2_1 


3.6 "PickPlace" block 


The function block "PickPlace" contains a Example Program in the form of a simple 


pick & place application. The robot goes through the following movement profile: 


e Home position 
e Pick position 

e Place position 
e Home position 


Figure 3-35: Movement sequence of the simple pick & place application 


The following table contains the functionalities used for this. 


Table 3-9: "PickPlace" function overview 


Functionality 


Abort active and buffered commands 


Function block 
KRC_ Abort (FB915) 


Interrupt active and buffered commands 


KRC_ Interrupt (FB916) 


Continue interrupted and buffered 
commands 


KRG _ Continue (FB917) 


Write individual elements of the structure 


mxA_ ValuesToAPO (FC904) 
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APO 


Functionality 


Function block 


COORDSYS 


Write individual elements of the structure 


mxA ValuesTOCOORDSYS (FC903) 


Move robot axes to a defined position 


MC_MoveAxisAbsolute (FB992) 


Move the robot in a linear path to a 
Cartesian position 


MC_MoveLinearAbsolute (FB997) 


The positions to be approached are located in the data block "MxADBPosition" in 
the following memory cells: 


e MxADBPosition.KRC_AxisGroupRefArr[1].PositionArray[1]. 


e MxADBPosition.KRC_AxisGroupRefArr[1].PositionArray[5] 


The blocks are called as shown below. 


Figure 3-36: "PickPlace" program sequence 


FB 


$7-1500 / KUKA mxAutomation 


PickPlace 


FB 


KRC_ 
Interrupt 


KRC_ 
Continue 


FC 
mxAValues 
to 

APO 


FC 
mxAValues 
to 
COORDSYS 


FB 
MC_Move 
Axis 

Absolute 


FB 

MC_Move 
Linear 

Absolute 


FB 
MC_Move 
Linear 
Absolute 


FB 

MC_Move 
Linear 

Absolute 


FB 
MC_Move 
Linear 

Absolute 
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3.6.1 KRC_ Abort 


First, call the function block "KRC_Abort" (FB915). This aborts all active and 


buffered instructions and movements on a rising edge on the "ExecuteCma" input. 


Figure 3-37: Aborting active and buffered commands. 


YFB915 
"KRC_Abort™ 
Busy — --- 
Done — --- 
== EN Error — --- 
J == AxisGroupldx ErrorlD — --- 
‘alse —= ExecuteCmd ENO — 


3.6.2 KRC_Interrupt 


All commands are interrupted with the function block "KRC_Interrupt" (FB916). For 
this purpose, a BRAKE or BRAKE-F instruction is triggered in the robot controller. 


If a BRAKE or BRAKE-F instruction is active, no further instructions are processed 
via the mxA interface. Also, the function block "KRC_Abort" is no longer processed. 


Instructions are not accepted again until the program has been continued with 


"KRC_Continue". In this state, the program can only be aborted by a "RESET" on 


the function block "KRC_AutomaticExternal". 


Figure 3-38: Interrupting an active program 


TFB916 
*KRC_Interrupt 
--—=EN BrakeActive — --- 
0 == AxisGrouplidx Error — --- 
false —— Execute ErrorlD —~ --- 
fe ise —— Fast ENO — 


3.6.3 KRC_Continue 


Call the function block "KRC_Continue" (FB917) to continue a program interrupted 


by the block "KRC_Interrupt". 


Figure 3-39: Continuing an interrupted program 


4FB917 
"KRC_Continue” 
--== EN Error —— --- 
2 —= AxisGroupidx ErrorlD — --- 
false —= Enable ENO — 


CAUTION _— If movement jobs are still active in the robot controller, they are 


immediately continued by the triggering of "KRC_Continue”. 
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3.6.4 mxA_ValuesTOoCOORDSYS 


Individual elements are written to the structure COORDSYS with the function 
"mxA_ValuesTOCOORDSYS" (FC903). This contains information about which 
coordinate systems should be selected. 


Figure 3-40: Define coordinate systems 
%FC903 
“mxA_ValuesToCOORDSYS"™ 


COORDSYS — <???> 
<2?2>— IPO_Mode ENO — 


Table 3-10: Inputs of the function "mxA_ValuesToCOORDSYS" 


Input Description 


Tool Selection of the number of the tool 
coordinate system or the active tool. 


Base Selection of the number of the base 
coordinate system to be used. 


whether the tool is mounted on the 
mounting flange or stands firm. 


IPO_Mode Selection of the interpolation mode, i.e. 


3.6.5 mxA_ValuesToAPO 


The function "mxA_ValuesToAPO" (FC904) writes individual elements into the 
structure APO (Approximation). This contains the blend parameters for a 
movement command. 


Figure 3-41: Parameterizing blending 
%C904 
“mxA_Values TOAPO" 
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Table 3-11: Inputs of the "mxA_ValuesToAPO" function 


PTP_MODE 


Input 


Description 


Specifies whether and how the target point 

of a PTP movement is blended. 

e 0 Without blend (default) 

e 1: Causes the target point to be 
blended. 

For PTP-PTP blending, the specification 

CPTP is sufficient. 

In PTP-CP blending, i.e. when a LIN or 

CIRC set follows the blended PTP set, a 

further blending parameter must be 

specified. 

e 2: PTP-CP blending with distance 


parameters 

e 3: PTP-CP blending with orientation 
parameters 

e 4: PTP-CP blending with velocity 
parameters 


CP_MODE 


Specifies whether and how the target point 
of a CP movement 


(LIN, CIRC) is blended. 

e 0 Without blend (default) 

e 1: Blending with distance parameters 

e 2: Blending with orientation parameters 
e 3: Blending with velocity parameters 


CPTP 


Blending distance as a percentage for a 
point-to-point movement, from which the 
blending should start at the earliest, before 
the target point. The maximum distance of 
100% marks half the distance between the 
start and end points. 


CDIS 


Distance to the target point in millimeters, 
the earliest point from which the blending 
should start. 


CORI 


Orientation parameter in degrees, the 
earliest point from which the blending may 
start, when the dominant orientation angle 
falls below the value specified here to the 
target point. 


CVEL 


Determination of the velocity as a 
percentage, the earliest point from which 
blending may start in the deceleration 
phase to the destination point. 
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Example 
If, in the case of two consecutive linear movements, distance-controlled blending 
must be performed, the block must be connected as shown below. 
Figure 3-42: Blending with two linear travel commands 
C904 
“mxA_Values ToAPO” 
= EN 
0 — PTP_MODE 
| — CP_MODE 
0 — CPIP 
100.0 — DIS 
0.0 — CORI APO —— #tempApo 
0 — CVEL ENO — 
The variable "tempApo" now contains the information that distance-controlled 
blending should be performed in linear and circular movements (CP_MODE = 1). 
On the CDIS input, the desired distance must be specified (here: 100 mm). This 
results in the following trajectory. 
Figure 3-43: Trajectory of the blended linear movements 
P2|—©s P3 
+ Oe ——_—@ 
CDIS | 
P1 
3.6.6 MC_MoveAxisAbsolute 


For the movement sequence of the robot, first the function block 
"MC_MoveAxisAbsolute" (FB992) is called in order to bring the robot arm into the 
home position. This movement block moves all axes of the robot to the axis values 
defined by the user. The positions of each individual axis must be transferred to 
this block as the position. The structure "E6AXIS" collectively contains all single 
values. 
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Figure 3-44: Move axes to an axis-specific target position 


UFB992 


"MC_MoveAxis Absolute™ 


--== EN 
~~ AxisGroupidx 
false —= Execute 


= AxisPosition CommandAborte 


— Velocity 
)—= Acceleration 
--- == Approximate 
0 —= QueueMode 


Table 3-12: Parameters of the movement block "MC_MoveAxisAbsolute" 


Interface Description 

Inputs 

AxisGroupldx Index of the axis group (as defined in 
chapter 3.4.1) 

Execute Starts / buffers movement at positive edge. 

Position Axis-specific target position: "E6AXIS" 

Velocity Velocity for path movement in 0 ... 100%. 
Refers to the specified maximum velocity of 
the respective robot type. 

Acceleration Acceleration for path movement in 0 ... 
100%. Refers to the specified maximum 
acceleration of the respective robot type. 

Approximation Blend parameters APO (see chapter 3.6.5) 

QueueMode Mode in which instructions are executed: 

e 1: ABORTING 
Instruction is immediately executed by 
the robot interpreter. Before this, all 
active movements and buffered 
instructions are aborted and the robot 
is brought to a halt. 

e 2: BUFFERED 
Instruction is buffered. Buffered 
instructions are processed by the robot 
interpreter according to the FIFO 
principle. 

Outputs 

ComAcpt Instruction has been completely transferred 
and confirmed by the robot controller. 

ComBusy Instruction is currently being transmitted 
and has not yet been confirmed by the 
robot controller. 

Busy Function block has not yet been completely 
executed. 

ACTIVE Movement is currently being executed. 

Done Movement has been completed 
successfully. 

Aborted Instruction / movement aborted. 

Error Error during execution of the function block. 

ErrorlD Error number 
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3.6.7 


Interface Description 


The assignment to the corresponding error 
message can be found in the KUKA manual 
"Siemens Library for KUKA.PLC 
mxAutomation" in the chapter "Messages". 


MC_MoveLinearAbsolute 


The other positions of the robot are approached in a linear path with the help of the 
function block "MC_MoveLinearAbsolute" (FB997). In a linear movement, the 
target position is given in Cartesian form. The robot controller interpolates a 
straight path between the current position and the target position. In such a 
movement, the robot always moves its tool on the shortest (but not necessarily 
quickest) route to the target point. 


Figure 3-45: Approach a Cartesian position in a linear path 


YFB997 
"MC_MoveLinearAbsolute” 


= EN 
~~ AxisGroupidx a 
Se —= Execute 
= ComBusy — --- 
--- == Position 
loci Busy — --- 
: ae =a ; Active — --- 
Acceleration a 
CoordinateSyste CommandAborte 
_-— mM a 
2 —~ OriType Error — --- 
-- —= Approximate ErrorlD — --- 
7 =~ QueueMode ENO — 


Since the position specification is not axial but Cartesian, the input expects the 
data type "E6POS". This contains all components of the Cartesian position (see 
also chapter 3.7.1). 


Table 3-13: Parameters of the movement block "MC_MoveLinearAbsolute" 


Interface Description 

Inputs 

AxisGroupldx Index of the axis group (as defined in 
chapter 3.4.1) 

Execute Starts / buffers movement at positive edge. 

Position Cartesian target position: "E6POS" 

Velocity Velocity for the path movement in 0... 2 
m/s. The maximum value depends on the 
respective robot type. 

Acceleration Acceleration for the path movement in 0 ... 
2.3 m/s?. The maximum value depends on 
the respective robot type. 

CoordinateSystem Coordinate system to which the Cartesian 
coordinates of the target position refer. 
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OriType 


Interface 


Description 


Orientation guide for the TCP 


e 0VAR 
Orientation of the TCP changes 
continuously during the movement. 


e 1: CONSTANT 
Orientation of the TCP remains 
constant during the movement. 


e = 2: JOINT 
The orientation of the TCP changes 
continuously during movement, but not 
evenly. This orientation type is not 
suitable if a specific course of the 
orientation must be precisely pursued. 


Approximation 


Blend parameters APO (see chapter 3.6.5) 


QueueMode 


Mode in which instructions are executed 


e 1: ABORTING 
Instruction is immediately executed by 
the robot interpreter. Before this, all 
active movements and buffered 
instructions are aborted and the robot 
is brought to a halt. 


e 2: BUFFERED 
Instruction is buffered. Buffered 
instructions are processed by the robot 
interpreter according to the FIFO 
principle. 


Outputs 


ComAcpt 


Instruction has been completely transferred 
and confirmed by the robot controller. 


ComBusy 


Instruction is currently being transmitted 
and has not yet been confirmed by the 
robot controller. 


Busy 


Function block has not yet been completely 
executed. 


ACTIVE 


Movement is currently being executed. 


Done 


Movement has been completed 
successfully. 


Aborted 


Instruction / movement aborted. 


Error 


Error during execution of the function block. 


ErrorlD 


Error number 

The assignment to the corresponding error 
message can be found in the KUKA manual 
"Siemens Library for KUKA.PLC 
mxAutomation" in the chapter "Messages". 
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3.7 "Circle" block 


The function block "Circle" contains a Example Program in the form of a simple, 
circular contour. The robot goes through the following movement profile: 


e Start position of the circular path 

e Circular path 

e Home position of the robot 

The following table contains the functionalities used for this. 


Table 3-14: "Circle" function overview 


Functionality Function block 
Abort active and buffered commands KRC Abort (FB915) 
Interrupt active and buffered commands KRC_ Interrupt (FB916) 
Continue interrupted and buffered KRC_ Continue (FB917) 
commands 
Write individual elements of the structure mxA_ ValuesToAPO (FC904) 
APO. 
Write individual elements of the structure mxA ValuesTOCOORDSYS (FC903) 
COORDSYS. 
Write individual elements of the structure mxA ValuesToE6POS (FC901) 
E6POS. 
Bring the robot into a Cartesian position on MC_MoveDirectAbsolute (FB995) 
the fastest trajectory. 
Move robot on a defined circular path. MC_MoveCircAbsolute (FB993) 


The home position is located in the data block "MxADBPosition" in the following 
memory cell: 


e MxADBPosition.KRC_AxisGroupRefArr[1].PositionArray[1]. 


$7-1500 / KUKA mxAutomation 
Entry-ID: 109482123, V1.5, 09/2020 


© Siemens AG 2020 All rights reserved 


3 Creating a program 


The blocks are called as shown below. 


Figure 3-46: "Circle" program sequence 


$7-1500 / KUKA mxAutomation 
Entry-ID: 109482123, V1.5, 09/2020 


49 


© Siemens AG 2020 All rights reserved 


3 Creating a program 


3.7.1 mxA_ValuesToE6POS 


With the function "mxA_ValuesTOE6POS" (FC901), individual elements are written 
in the structure "E6POS". This feature can be used to define Cartesian positions 


during the running program. 


Figure 3-47: Defining Cartesian position in the current program 


4FC901 
"mxA_Values ToE6 POS” 


Table 3-15: Inputs of the "mxA_ValuesToE6POS" function 


Inputs Description 
X,Y,Z Position on the axes of the active 
coordinate system 
A, B, C Rotation around the axes Z, Y, X 


Status, Turn 


Additional parameters for unambiguous axis 
positioning with Cartesian position 
specification (see chapter 3.5.10) 


E1 to E6 


Positions of the optional additional axes E1 
to E6 
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3 Creating a program 


3.7.2 MC_MoveDirectAbsolute 


The movement block "MC_MoveDirectAbsolute" (FB995) moves the robot on an 
unknown path to a Cartesian position as quickly as possible. This movement block 
executes a so-called point-to-point (PTP) movement. The robot controller is given a 
Cartesian target position and the path is not defined further there. The robot 
controller then calculates how the axes need to be moved in order to be in the 
specified target position as quickly as possible. Slower axes are moved less and 
faster axes are used more. 


Figure 3-48: Moving the robot into the home position 
SFB995 
"MC_MoveDirectAbsolute” 


~~ id ComAcpt — --- 
— AxisGrouplidx a — 
a!Se == Execute Busy — —- 

--- == Position a 

2 —= Velocity a 

) — Acceleration CommandAborte 

CoordinateSyste a 
-_—m Error — --- 
--- —= Approximate ErrorilD — --- 

J —= QueueMode ENO — 


Since the position is Cartesian, the "Position" input expects the data type "E6POS". 


Table 3-16: Parameters of movement block "MC_MoveDirectAbsolute" 


Interface Description 


Inputs 


AxisGroupldx Index of the axis group (as defined in 
chapter 3.4.1) 


Execute Starts / buffers movement at positive edge. 


Position Cartesian target position: "E6POS" 


Velocity Velocity for path movement in 0 ... 100%. 
Refers to the specified maximum velocity of 
the respective robot type. 


Acceleration Acceleration for path movement in 0 ... 
100%. Refers to the specified maximum 
acceleration of the respective robot type. 


CoordinateSystem Coordinate system to which the Cartesian 
coordinates of the target position refer. 


Approximation Blend parameters APO (see chapter 3.6.5) 


QueueMode Mode in which instructions are executed 


e 1: ABORTING 
Instruction is immediately executed by 
the robot interpreter. Before this, all 
active movements and buffered 
instructions are aborted and the robot 
is brought to a halt. 


e 2: BUFFERED 
Instruction is buffered. Buffered 
instructions are processed by the robot 
interpreter according to the FIFO 
principle. 
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Interface Description 

Outputs 

ComAcpt Instruction has been completely transferred 
and confirmed by the robot controller. 

ComBusy Instruction is currently being transmitted 
and has not yet been confirmed by the 
robot controller. 

Busy Function block has not yet been completely 
executed. 

ACTIVE Movement is currently being executed. 

Done Movement has been completed 
successfully. 

Aborted Instruction / movement aborted. 

Error Error during execution of the function block. 

ErrorlD Error number 
The assignment to the corresponding error 
message can be found in the KUKA manual 
"Siemens Library for KUKA.PLC 
mxAutomation" in the chapter "Messages". 


\ Since the path in a PTP movement is not known, insufficient tests can lead 


to significant damage to property and personal injury. 


WARNING 


3.7.3 MC_MoveCircAbsolute 


The movement block "MC_MoveCircAbsolute" (FB993) moves the robot on a 
circular path to a Cartesian target position. For the robot controller to calculate the 
circular path, an auxiliary position must be specified next to the target position. The 
auxiliary position cannot be blended. 


Figure 3-49: Circular movement of the robot 


IFB993 
"MC_MoveCircAbsolute" 
--== EN 
J == AxisGrouplidx 
Ta ise —— Execute 
-- —= Position 
~— e ComAcpt — --- 
a ash ComBusy — --- 
—— Velocity ; = — 
J —— Acceleration ee 
CoordinateSyste Done —-.- 
i CommandAborte 
2 —= OriType d—.. 
9 —= CircType Error — --- 
--- == Approximate ErrorlD — --- 
J —= QueueMode ENO — 
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Table 3-17: Parameters of movement block "MC_MoveCircularAbsolute" 


Interface Description 

Inputs 

AxisGroupldx Index of the axis group (as defined in 
chapter 3.4.1) 

Execute Starts / buffers movement at positive edge. 

Position Cartesian target position: "E6POS" 

CircHP Cartesian auxiliary position: "E6POS" 

Angle Central angle 
The central angle permits an extension of 
the movement beyond the programmed 
target point or a shortening of it. The actual 
target point thereby no longer corresponds 
to the programmed target point. 

Velocity Velocity for the path movement in 0... 2 
m/s. The maximum value depends on the 
respective robot type. 

Acceleration Acceleration for the path movement in 0 ... 


2.3 m/s?. The maximum value depends on 
the respective robot type. 


CoordinateSystem 


Coordinate system to which the Cartesian 
coordinates of the target position refer. 


OriType 


Orientation guide for the TCP 


e 0OVAR 
Orientation of the TCP changes 
continuously during the movement. 


e 1: CONSTANT 
Orientation of the TCP remains 
constant during the movement. 


e = 2: JOINT 
The orientation of the TCP changes 
continuously during movement, but not 
evenly. This orientation type is not 
suitable if a specific course of the 
orientation must be precisely pursued. 


CircType 


Orientation guide for the circular movement: 
e 0BASE 
Base-related orientation guide during a 
circular movement 
e 1: PATH 
Path-related orientation guide during a 
circular movement 


Approximation 


Blend parameters APO (see chapter 3.6.5) 
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3 Creating a program 


QueueMode 


Interface 


Description 


Mode in which instructions are executed 


e 1: ABORTING 
Instruction is immediately executed by 
the robot interpreter. Before this, all 
active movements and buffered 
instructions are aborted and the robot 
is brought to a halt. 

e 2: BUFFERED 
Instruction is buffered. Buffered 
instructions are processed by the robot 
interpreter according to the FIFO 
principle. 


Outputs 


ComAcpt 


Instruction has been completely transferred 
and confirmed by the robot controller. 


ComBusy 


Instruction is currently being transmitted 
and has not yet been confirmed by the 
robot controller. 


Busy 


Function block has not yet been completely 
executed. 


ACTIVE 


Movement is currently being executed. 


Done 


Movement has been completed 
successfully. 


Aborted 


Instruction / movement aborted. 


Error 


Error during execution of the function block. 


ErrorlD 


Error number 

The assignment to the corresponding error 
message can be found in the KUKA manual 
"Siemens Library for KUKA.PLC 
mxAutomation" in the chapter "Messages". 
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3 Creating a program 


3.8 


3.8.1 


Operation 


If the HMI is loaded or simulated via Runtime, the following interface opens. 


Figure 3-50: Start screen of the user interface. 
Robot Control 


Override 80 % 
No Error Power On Interpreter ready 


Jog Mode Axis Overview 


AA ae 
= a \ ; fa 
AG ~ Bl 

Ke 


Jog in Axis 


Power Off 


+0.00° 


-90.00 ° 


+90.00° 


+0.00° 


+90.00° 


BERR 


-0.00° 


Start 
Pick and Place 


Point Nr. TEACH 
Start 


Circle 


Status bar and Override 


The status bar contains basic information about the status of the robot as well as 
the control of the override. 


Figure 3-51: Status bar 


“ 9 
0% 10 4 vere S0ks rs +10 100% 
No Error Power On Interpreter ready 


1. "State" collectively indicates whether an error is pending on the robot or the 
mxAutomation interface. 


2. "Power" indicates if the robot is switched on. 


3. "Interpreter" indicates whether the robot interpreter is active and waiting for 
instructions. 


4. "Override" shows the currently set value. The buttons on the left and right of 
the display control the override. 
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3.8.2 Control functions 


The control functions can be used to control administrative functions of the robot. 
Figure 3-52: Control functions 


Power On 


Power Off 


"Power On" switches on the robot. 
2. "Power Off" switches off the robot. 


3. "Reset" acknowledges all pending error messages. If an error message is 
pending, the robot switches off and cannot be switched on again until the error 
has been acknowledged. 


4. "Abort" aborts all active and buffered commands, such as the Example 
Programs. 
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3.8.3 Jogging the robot 


The robot can be moved in either an axial or Cartesian manner in jog mode. To do 
this, the corresponding mode must be selected as shown below. 


Figure 3-53: Axial robot jogging 


Jog Mode Axis Overview 
Al = | +0.00° 
A2 | — | -90.00° 
A3 | = | +90.00° 
A4 | = | +0.00 ° 
AS | = | +90.00° 
A6 | = | -0.00° 


Point No. 


1. Press one of the two buttons to switch to the corresponding jog mode. "Jog in 
Axis" moves the robot axially. With "Jog in Base", the robot is moved along the 
coordinate axes. The inactive mode is greyed out. 


2. Use the plus and minus buttons to move the corresponding axis (here A2) in 
the positive or negative direction. The displayed axis value describes the 
current axis position. 


3. The "TEACH" button saves the current position. The index is defined by "Point 
No.". When the operation is completed successfully, "Done" lights up. In the 
event of a fault, "Error" lights up. 


4. "Axis Overview" shows the assignment of the axis numbers to the actual axes 
of the robot arm. 
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The following illustration shows the view for Cartesian jogging. 


Figure 3-54: Cartesian robot jogging 


Jog Mode Axis Overview 


Jog in Base 


| — | +390.00 mm 

y 200mm 
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Operation is identical to that for axial jogging. 


1. Use the plus and minus buttons to move in a positive or negative direction 
along the corresponding axis. The parameters A (RZ), B (RY) and C (RX) 
control the rotation about the respective axes 


2. “Axis Overview" shows the coordinate systems of the robot. Movement occurs 
in line with the global coordinate system, which is stored in the root of the robot 
arm. 


CAUTION _ The rotations A, B and C describe the rotation about the axes Z, Y, X. The 


rotations about the axes X and Z are reversed. 


3.8.4 Example Programs 


The Example Programs described in sections 3.6 and 3.7 can be started via the 
following buttons. 


Figure 3-55: Start Example Programs 


Start 
Pick and Place 


Start 
Circle 


When one of the buttons is pressed, the entire Example Program is run. 
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3.9 


3.9.1 


Problem 


Solution 


Error handling 


In the following section, you will find some typical error cases and solutions to 
rectify them. 


HMI only shows rhombuses 
On the user interface, rhombuses are displayed instead of the robot data. 


The rhombuses indicate that the HMI has no connection to the SIMATIC controller. 


If you are using a real panel, check whether the PROFINET connection to the 
panel exists. To do this, first check the cable connection to your SIMATIC 
controller. If there is no error here, terminate the runtime on the panel and open the 
system settings. Select "PROFINET" and make sure that the checkbox 
"PROFINET IO enabled" is selected. 


If you use a runtime on your local machine, check whether the PG/PC interface is 
configured correctly. To do this, select the HMI in the project tree in the TIA Portal 
and open "Connections". 


Figure 3-56: HMI connection 


KUKA_BASIC_EXAMPLE_1516F_HMI > HM_1[TP1500 Comfort] > Connections 


| Devices 


[=] BY | a connections to $7 PLCs in Devices & Networks 

Connections 
Name Communication driver HM time synchronization mode _Station 

sh HM_Verbindung_1  SIMATICS7 1500 None [=| $71500!e7 
<Add new> 


y _] KUKA_BASIC_EXAMPLE_1516F_HMI [ } 
Add new device 
gh Devices & networks 
> [ig PLC_1 [CPU 1516F-3 PN/DP] e 
> [i HML_1 [171500 Comfort] 
BY Device configuration 
&| Online & diagnostics 
Y Runtime settings 
~ [Screens 
i Add new screen 
000.1_System 
> [Be] SIEMENS_APPLICATION_EXAMPLE 
5) 01_POWER_ON 


Parameter | Area pointer 


TP1500 Comfort 


Interface: 
ETHERNET ka 
> lig) Screen management 


= HMI device 
[ "2, Connections ] feet - : 
kp Recipes Access point: |S7ONLINE 
GW) Historical data \ So) 
» (8) Scripts 


55) Scheduled tasks 
©) Gcles 
> [Ey Reports 
EQ] Test and graphic lists 
99 User administration 


> [EX Ungrouped devices 
> [a9 Common data 
» [El] Documentation settings 
» [@ Languages & resources 
> [gp Online access 
> [ip Card ReaderiUSB memory 


Check the configured access point of the HMI. Now open the Windows Control 
Panel and select "Configure PG/PC Interface". In the window that opens, select the 
access point in the drop-down menu (here: S7ONLINE) and assign the interface 
that is connected to the SIMATIC controller. 
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3.9.2 


Problem 


Solution 


3.9.3 


Problem 


Solution 


Figure 3-57: Configuring the PG/PC interface 
Set PG/PC Interface 


Access Path | LLDP / DCP | PNIO Adapter | Info | 


Access Point of the Anolication: 


S7ONLINE (STEP 7) -> Intel(R) PRO/1000 MT-Netzwerkverbindig 


(olangard tor S1cr 7) 


Interface Parameter Assignment Used: 


Intel(R) PRO/1000 MT-Netzwerkverbindun 


Intel(R) P 


(Parameter assignment of your NDIS-CP 
with TCP/IP protocol (RFC-1006)) 


No connection to the robot controller 


There is no connection to the robot controller. The device is not found via 
PROFINET. 


First, make sure all cable connections are in place. If you have just installed 
mxAutomation via KUKA WorkVisual, reboot the controller with "Refresh data". To 
do this, you must log on as (at least) an Expert on the robot controller and select 
"Shutdown" in the menu. Set the check mark for "Re-read data" and press the 
button "Restart control PC". 


MxA interface is not initialized 


The connection to the robot has been established, but the robot cannot be moved. 
Initialization has not been completed successfully. The "KRC_Initialize" block does 
not send a Done signal. 


Check whether the address ranges set in the hardware configuration match the 
input and output start bytes of the function blocks "KRC_ReadAxisGroup" and 
"KRC_WriteAxisGroup". 


If the problem persists, check if ProConOS is installed. Log on to the 
KUKA.smartPAD as (at least) an Expert and in the menu under "Commissioning", 
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3.9.4 


Problem 


Solution 


select the item "Additional software". Here, you can see all installed option 
packages. ProConOS must be one of these installed option packages. If it is not 
installed, you will need to install it directly on the robot controller. If necessary, 
contact KUKA Robot Support. 


The robot cannot be switched on 


The connection to the robot is established, the initialization is successfully 
completed and "EXT" mode is selected. However, the robot cannot be switched on. 


Examine the "ErrorlD" output of the "KRC_AutoStart" block. This may indicate the 
hexadecimal value 020F during the first startup. You will find the entry "TIMEOUT 
MESSAGE CONFIRM" under this number in the KUKA manual "Siemens Library 
for KUKA.PLC mxAutomation" in the "Messages" chapter. Acknowledge pending 
error messages once directly on the robot controller via the KUKA smartPad. If 
necessary, change to "T1" mode. 
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4 Advanced fundamentals and additional functions 


4 


4.1 


4.2 


4.2.1 


Advanced fundamentals and additional 
functions 


This chapter is intended to introduce you to selected additional functions that go 
beyond the basic control of a KUKA industrial robot using the KUKA.PLC 
mxAutomation library. Additionally, you will find the information what needs to be 
considered by the selection of the correct CPU. 


Selection of the correct CPU 


The SIMATIC Robot Integrator is basically designed for controllers of the SIMATIC 
S7-1500 series. The required size of the controller depends above all on the 
number of robots used, the respective robot positions and the trajectory paths to be 
traversed, as these are stored remanently. Therefore, the retentive memory of the 
controller must be large enough for the respective application. However, the 
retentive memory can also be increased by a corresponding power supply module, 
whereby even smaller controllers can theoretically store more robot positions and 
thus control several robots. 


If an additional safety device is to be integrated in the control system, a SIMATIC 
S7-1500F controller is required. 


Safety Integrated 


KUKA provides the SafeOperation safety option for the use of the Safety Integrated 
functionality together with a KUKA industrial robot: 


Components 


The following components are included in the KUKA SafeOperation security option: 


Software components 


Table 4-1: KUKA Components - SafeOperation Safety Option 


Component Qty. Article number Note 
KUKA.SafeOperation Version: V3.2 


=? 


Hardware components 


4.2.2 


Table 4-2: KUKA Components - SafeOperation Safety Option 


Component Qty. Article number Note 
Reference button 1 For automated checking of the 
assembly safety areas set on the robot. 


Functionality 


The KUKA SafeOperation security option includes the following functionality: 


e Secure monitoring of a maximum of 16 user-defined axis-specific or Cartesian 
monitoring areas. 


e Secure monitoring of a custom cell range. 
e Secure monitoring of axis-specific velocities. 
e Secure monitoring of room-specific velocities. 
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4.2.3 


4.3 


Note 


e Secure monitoring of Cartesian velocities. 

e Modeling of up to 16 secure tools with secure TCP. 

e Secure stop via the safety control. 

e Secure operating stop for up to 6 axis groups. 

e Secure inputs for activating monitoring. 

e Secure outputs for monitoring status messages. 

e Creation and editing of the security configuration on the robot controller. 


Control 


The SafeOperation safety option is controlled via the PROFINET connection 
between the SIMATIC controller and the robot controller using the PROF Isafe 
telegram. 


If this connection is to be used, the PROF lsafe extension can be easily integrated 
into the telegram configuration of the KUKA robot controller. The PROFlsafe 
telegram extension is already included in the GSDML file of the KUKA robot 
controller. 


Figure 4-1: Control of the safety option SafeOperation via PROF Isafe 


[® Topology view [sh Network view [IN Device vew 


As an alternative to data exchange via PROF Isafe, the safety functions of the 
robot can also be controlled via discrete hardware signals via interface X11 of 
the robot controller. 


Receive robot messages in plain text 


In addition to the blocks mentioned in the previous chapters for determining status 
and error messages of the robot controller and the data interface of the KUKA.PLC 
mxAutomation block library, it is possible to receive robot messages from the robot 
controller in plain text via a UDP interface. 


The robot controller outputs all robot messages via a UDP connection on the 
PROFINET connection. These messages can be received in the SIMATIC 
controller and, if necessary, displayed on the HMI operator panel. 


This functionality is included in the more comprehensive application example. 
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Appendix 


Advanced example 


In addition to the basic application example described here, there is also a more 
extensive example. This can be requested from a local Siemens representative. 


The Advanced Example is designed so that it can be used directly on a real 
machine because of its functionality. The visualization on the SIMATIC panel 
accordingly offers significantly more operating options. The following functions, in 
addition to others, are included in addition to the functions described in the basic 
example: 


Table 5-1: Additional functions of the Advanced Example 


Function Description 


More detailed diagnostic data The status messages on the user interface 
are more detailed. 


Individual movements The robot can move to the desired position 
via the user interface in either an axial or 
Cartesian manner. 


Online programming Robot programs can be programmed 
directly via the user interface. (Similar to 
inline forms on the SmartPAD) 


Configuration Tool or base coordinate systems as well as 
load data and software limit switches can 
be viewed and modified via the user 
interface. 


Error messages Error messages that are usually displayed 
on the KUKA.smartPAD are displayed 
directly on the user interface. 


Figure 5-1: Start screen of the KUKA Advanced example 
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5.2 Service and support 


Industry Online Support 
Do you have any questions or need assistance? 


Siemens Industry Online Support offers round the clock access to our entire 
service and support know-how and portfolio. 


The Industry Online Support is the central address for information about our 
products, solutions and services. 


Product information, manuals, downloads, FAQs, application examples and videos 
— all information is accessible with just a few mouse clicks: 


support.industry.siemens.com 


Technical Support 


The Technical Support of Siemens Industry provides you fast and competent 
support regarding all technical queries with numerous tailor-made offers 
— ranging from basic support to individual support contracts. 


Please send queries to Technical Support via Web form: 
support.industry.siemens.com/cs/my/src 


SITRAIN - Digital Industry Academy 


We support you with our globally available training courses for industry with 
practical experience, innovative learning methods and a concept that’s tailored to 
the customer’s specific needs. 


For more information on our offered trainings and courses, as well as their 
locations and dates, refer to our web page: 


siemens.com/sitrain 


Service offer 
Our range of services includes the following: 
e Plant data services 
e Spare parts services 
e Repair services 
e On-site and maintenance services 
e Retrofitting and modernization services 
e Service programs and contracts 


You can find detailed information on our range of services in the service catalog 
web page: 


support.industry.siemens.com/cs/sc 


Industry Online Support app 


You will receive optimum support wherever you are with the "Siemens Industry 
Online Support" app. The app is available for iOS and Android: 


support.industry.siemens.com/cs/ww/en/sc/2067 
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5 Appendix 


5.3 


5.3.1 


5.3.2 


5.3.3 


Contact partners 


Here, you can find the contact information for further questions about KUKA 
industrial robots or the KUKA.PLC mxAutomation block library, or to request the 
necessary KUKA documentation. 


KUKA Roboter GmbH 


KUKA Roboter GmbH — Headquarters KUK A 
ZugspitzstraBe 140 


86165 Augsburg 


Tel.: +49 821 797-4000 
Fax: +49 821 797-4040 


E-mail: info@kuka-roboter.de 


KUKA Roboter GmbH Hotline 


KUKA Roboter GmbH — Hotline KUKA 


The hotline is open 24 hours a day, 365 days a year 
in Germany: 


Tel.: +49 821 797-1926 


Sales and Marketing for KUKA.PLC mxAutomation 


KUKA Roboter GmbH — Global Sales Center KUK A 
Hery-Park 3000 
86368 Gersthofen 


Tel.: +49 821 4533-0 
Fax: +49 821 4533-1616 


E-mail: sales@kuka-roboter.de 
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5 Appendix 


5.4 Links and literature 


Table 5-2 


No. 
\1\ 


Topic 


Siemens Industry Online Support 
https://support.industry.siemens.com 


\2\ 


Link to the article page of the application example with KUKA robot 
httos://support.industry.siemens.com/cs/ww/en/view/109482123 


\3\ 


Link to the article page of the application example with STAUBLI robot 
httos://support.industry.siemens.com/cs/document/109762450 


\4\ 


Link to the article page of the application example with DENSO robot 
https://support.industry.siemens.com/cs/ww/en/view/109761432 


Siemens SIMATIC S7 / Safety Integrated 


\5\ 


SIMATIC 

STEP 7 Professional V15 

System manual 

Output: 12/2017 

Document ID: Printout of the online help 
Order number: - 


httos://support.industry.siemens.com/cs/ww/en/view/109755202 


\6\ 


SIMATIC PROFINET system description 
System manual 

Output: 03/2012 

Document ID: A5E00298287-06 

Order number: - 


https://support.industry.siemens.com/cs/ww/en/view/19292127/ 


\Z\ 


SIMATIC Industrial Software 

SIMATIC Safety - Configuration and Programming 
Programming and Operating Manual 

Output: 11/2014 

Document ID: A5E02714439-AD 

Order number- 
httos://support.industry.siemens.com/cs/ww/en/view/541 10126 


KUKA.PLC mxAutomation 


\8\ 


KUKA Robotics 


http:/Awww.kuka-robotics.com 
KUKA Download Center 


httos://www.kuka.com/en/services/downloads 


\9\ 


KUKA System Software 

KUKA System Software — Version 8.3 

Operating and programming instructions for system integrators 
Output: 12/18/2012 

Version: KSS 8.3 SI V1 de (PDF) 

Order number: - 

This documentation can be obtained via the KUKA Hotline. 


\10\ 


KUKA System Technology 

KUKA.PLC mxAutomation S7 — Version 2.0 

Product Description and Manual 

Output: 02/06/2017 

Version: Siemens_Library_mxAutomation_30_eng.pdf 
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No. Topic 
Order number: - 
This documentation can be obtained via the KUKA Hotline. 
\11\_ | KUKA System Technology 
KUKA.SafeOperation — Version 3.2 
Assembly and Operating Instructions 
Output: 03/18/2013 
Version: KST SafeOperation 3.2 V2 de 
Order number: - 
This documentation can be obtained via the KUKA Hotline. 
\12\_ | KUKA Controller Option 
KUKA.PROFINET Controller/Device 3.2 
Documentation 
Output: 07/06/2017 
Version: KUKA.PROFINET 4.1 V1 
Order number: - 
This documentation can be obtained via the KUKA Hotline. 
5.5 Change documentation 
Table 5-3 
Version Date Change 
V1.0 01/2016 First version 
V1.1 01/2016 Text Adaptations 
V1.2 05/2017 Revision and Updating 
V1.3 11/2019 Revision and Updating 
V1.4 08/2020 Revision and Updating 
V1.5 09/2020 Revision and Updating 
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